home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / system / argus151.zip / ENGLISH / README < prev   
Text File  |  1994-05-04  |  12KB  |  275 lines

  1.  
  2.  
  3.                      What is ARGUS.COM doing ?
  4.                      =========================
  5.  
  6. ARGUS  - logs essential system activities of DOS into a text file.
  7.        - works complete in the background (without screen output).
  8.  
  9. This might be usefully if a program hangs up with 'unexplicable' messages
  10. (e.g. 'Out of Memory', 'File not found' and so on). Sometime it is
  11. already interesting, which interrupts are 'corrupted'.
  12.  
  13. Since version 1.3 the printer output can be redirected in an file. This
  14. makes sense, if one searchs the reason for 'char confusion' on the paper,
  15. or if no printer is available. (printer substitute)
  16. After that the file can be printed with: COPY /B ARGUS.PRN PRN .
  17.  
  18. The resident part of ARGUS occupies in dependence of the choosed options
  19. between 3.4 and 5 KByte of memory, thus no impairment to the inspected
  20. program should occure.
  21.  
  22. The file ARGUS.LOG contains an example log.
  23.  
  24. ARGUS REQUIRES: CPU 286 or above, MS-DOS 3.3 or above
  25. --------------------------------------------------------------------------
  26.  
  27. I understand this program as 'FREEWARE', i.e., anybody can get it
  28. free of charge (in the sense of distribution to the prime cost).
  29.  
  30. 'Of course' I give NO WARRANTY that ARGUS works correct on your computer.
  31.  
  32.  
  33. (c)   M. Heilfort
  34.       Ernst-Moritz-Arndt-Universitaet
  35.       FB Physik
  36.       F.-Ludwig-Jahn-Str. 16
  37.       D-17487 Greifswald
  38.       Germany
  39.  
  40. E-Mail: heilfort@ap01.physik.uni-greifswald.de
  41.  
  42. Picture postcards and helpful comments are welcome.
  43. -------------------------------------------------------------------------
  44.  
  45.  
  46.  
  47.                            Description
  48.                            ===========
  49.  
  50.  
  51. ARGUS -- log of system activities
  52.  
  53. Call:  ARGUS  [ log file ] [ options ] [ /P [ print file ] ]
  54. ~~~~~
  55. Presettings:     log file   = ARGUS.LOG
  56. ~~~~~~~~~~~~     print file = ARGUS.PRN
  57.                  options    = /d/f /c
  58.  
  59. Options:  /? , -?  : Show this help
  60. ~~~~~~~~  /a , -a  : Log all activities
  61.           /d , -d  : Log access to directories
  62.           /e , -e  : Log using of EMS
  63.           /em, -em : Log using of EMS and mapping
  64.           /f , -f  : Log access to files
  65.           /i , -i  : Log modifications of the INT table
  66.           /l , -l  : Log access to drives
  67.           /m , -m  : Log the memory managment
  68.           /c , -c  : Complete error messages
  69.           /s , -s  : Permanent saving of the log file
  70.           /p , -p  : Redirect the printer output into the print file
  71.  
  72. To remove ARGUS simple run it again.
  73.  
  74.  
  75. The options in detail
  76. ~~~~~~~~~~~~~~~~~~~~~
  77. /D   ARGUS reports operations, which apply to directories.
  78. ~~~
  79. /L   ARGUS reports operations, which apply to drives.
  80. ~~~
  81. /F   Log of file operations. Not only FCB but also handle functions
  82. ~~~  are supervised. To save memory ARGUS doesn't remember the file name
  83.      which belongs to a handle, i.e., all file operations are logged
  84.      only with the handle number. Indeed, the reference to the file name
  85.      is given while opening a file.
  86.  
  87. /I   Redefinitions of Interrupts via DOS function are reported with
  88. ~~~  INT number and address of the INT handler.
  89.      Furthermore, the INT vectors 00h..1Ch, 20h..3Fh and 60h..7Fh are
  90.      supervised with a check sum to detect 'hard' manipulations.
  91.      In the case of change a warning occures.
  92.      But not every warning reports an illicit manipulation, the
  93.      COMMAND.COM sometime goes an 'internal' way.
  94.  
  95. /M   ARGUS logs memory allocation and release by DOS functions 48h..4Ah.
  96. ~~~  Additionally the size of remaining memory is reported bevor a
  97.      program is executed.
  98.  
  99. /E   ARGUS only knowes the functions of EMM 3.0. In 99% of all cases
  100. ~~~  this should work. Unknown EMM functions are logged with the
  101.      contents of register AX (= function number).
  102.  
  103. /EM  As the option /E. Additionally every mapping of an EMS page into a
  104. ~~~  page frame is reported. With programs heavy using EMS one should
  105.      choose this combination only, if sufficient capacity on the hard
  106.      disk is left !
  107.  
  108. /A   Last not least it should be remembered that the option /A is equal
  109. ~~~  to /D/EM/F/I/L/M, i.e., it very quickly 'produces' a big log file.
  110.  
  111. /C   With this option one gets complete error messages, otherwise the
  112. ~~~  logged funktion is only commented with 'OK' or 'FAIL !'.
  113.  
  114. /S   The option /S is only recommented, if there is the risk of system
  115. ~~~  crash, since the permanent saving of the log file slowes down
  116.      the program execution.
  117.      NOTE: You should disable a write cache (e.g. SMARTDRV).
  118.  
  119. /P   ARGUS redirects the printer output into a print file. This works
  120. ~~~  with BIOS function (INT 17h) as well as with DOS functions
  121.      (function 5, handle 4 or file 'PRN').
  122.      In the most cases it works with the 'print screen' key, too.
  123.  
  124.  
  125. Remarks:
  126. ~~~~~~~~
  127. The preseted options '/D/F/C' are only valid if there are no options
  128. choosed in the command line. If you ADDITIONALLY want to supervise e.g.
  129. the EMS, you've to use '/D/F/C/E'.
  130. If one of the options '/D/E/F/I/L/M' is used together with '/A', then it
  131. is turned off, i.e. '/A/E' is equal to '/D/F/I/L/M' (all except EMS).
  132.  
  133. You can write all options in upper cases as well as in lower cases.
  134. The order of the parameters is equal with one exception:
  135. If the option /P is used, the name of the log file must stand before
  136. and the name of the print file always after this option.
  137. Between options and file names should be at least one space.
  138. A missing file extender will be read as '.LOG' or '.PRN'.
  139. The file names can contain an path name. If it is omitted, the
  140. directory is used, which is the current one, when ARGUS starts.
  141. Later directory changes doesn't matter.
  142. (HINT: The complete(!) file name must not be longer than 120 chars.)
  143.  
  144. It goes without saying, that during the log not only the drive and
  145. the directory (may be difficult with floppy or network!) but also
  146. the log file itself has to be permanently accessible.
  147.  
  148.  
  149. ARGUS logs independend of the choosed options every program start and
  150. the corresponding termination. This lines are particularly marked, so
  151. that you easily can find which messages correspond to which program.
  152.  
  153. The allocation of user actions to the therby initiated program
  154. activities can be done by the logged time. In the simplest way one
  155. waits bevor every input, e.g. one minute.
  156.  
  157. You can avoid unnecessary messages within the log file, if you start
  158. ARGUS and the supervised program directly from DOS, i.e. not within 
  159. a batch file or a user interface.
  160.  
  161. Bevor a program starts and after its termination you can get 'gaps'
  162. into the log file. I assume that it is caused from the fact, that DOS
  163. is not reentrant and the COMMAND.COM uses some DOS functions in a direct
  164. way. Nevertheless, ARGUS reports this (rare) case with a line as
  165. 'log file incomplete'.
  166.  
  167.  
  168. In contrast to all earlier versions ARGUS V 1.5 now automatically detects
  169. the best position in memory and loads the resident part to this place.
  170. Do NOT use LOADHIGH any more.
  171.  
  172. The resident size depends on the following states:
  173.  
  174.    EMS logged  │ complete error messages │ resident size
  175. ───────────────┼─────────────────────────┼───────────────
  176.       no       │            no           │   3424 Byte
  177.       no       │            yes          │   4016 Byte
  178.       yes      │            no           │   4688 Byte
  179.       yes      │            yes          │   4880 Byte
  180.  
  181.  
  182.  
  183. Structure of the log file
  184. ~~~~~~~~~~~~~~~~~~~~~~~~~
  185. 1.) Header with date and time, e.g.:
  186. ~~~
  187.    ARGUS V1.51  -  (c) by M. Heilfort, May 1994
  188.  
  189. May, 03 1994
  190. 02.20.30 :  ------- start of log --------
  191.          :  resident ARGUS occupies 4880 Byte
  192.  
  193. 2.) Messages with the following structure:
  194. ~~~
  195. time     :  logged function          : parameter of the function
  196.  
  197. with choosed option /C in the error case a second line followes:
  198.  
  199.             error numb.: error message
  200.  
  201. Example:
  202.  
  203. 02.20.35 :  create directory       : argus.dem  OK
  204. 02.20.35 :  change directory       : argus.dem  OK
  205. 02.20.35 :  query current directory: C:\ARGUS\ARGUS.DEM  OK
  206. 02.20.35 :  remove directory       : C:\ARGUS\ARGUS.DEM  FAIL !
  207.             error   16 :  can'